home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / SCIENCE / PTCH_230.ZIP / PATCHIT.HLP < prev    next >
Text File  |  1993-12-16  |  64KB  |  2,184 lines

  1.  Hello.  This is Patchit's help file.
  2. The format is fairly simple.  the "hs" code indicates
  3. a help section.  The two numbers that follow are the level
  4. and the section.  These are organized in a hierarchical fashion,
  5. so that help for higher levels are immediately after the lower
  6. levels.  Oh well, it's easier for you to figure it out than it
  7. is for me to explain it.  The boh indicates the "beginning of
  8. help" code and the eoh is the "end of help" code.  Anything
  9. between these markers will be displayed by Patchit for that help
  10. level and section, so feel free to add more if you need to.
  11.  
  12. hs:0:0:Patchit
  13. boh
  14. Main Menu
  15.   Use the "/" or "F10" Key to access
  16. the menubar, then use the cursor keys
  17. or the highlighted letters to make
  18. your selection
  19.   A submenu may be pulled down by
  20. holding down the "ALT" key while typing
  21. the letter corresponding to the submenu
  22. OR select with the mouse.
  23.  
  24. Patchit is written and Copyright (1993-89)
  25.  by:
  26.    George B. Grant        (617) 625-2419 (Home)
  27.    38 Banks St. #2        (617) 625-2419 (Work)
  28.    Somerville, MA  02144
  29.    USA
  30.  
  31.    ggrant@husc.harvard.edu
  32.      - or -
  33.    george@mander.berkeley.edu
  34.  
  35.    72361,1116            (Compuserve address)
  36.  
  37.  - Please bring any bugs, complaints,
  38. suggestions or whatever to my attention.
  39. eoh
  40.  
  41. ------------------- File -----------------------
  42. hs:0:1:File
  43. boh
  44. File Menu
  45.   - Read Parameters  - Load a new set of parameters
  46.                         for data acquisition
  47.   - Write Parameters - Save the current parameter
  48.                         set to file
  49.   - Save Data File   - Save the latest set of
  50.                         acquired data to a file
  51.   - Options          - Set file related options
  52.   - DOS Shell        - Allows the user to temporarily
  53.                         exit to DOS
  54.   - About            - Shows helpful information
  55.                         about Patchit
  56.   - Quit Program     - Exits the program
  57. eoh
  58.  
  59. ------------------- Read Parameters ------------------
  60. hs:1:1:Read Parameters
  61. boh
  62.   This allows the user to load a new set
  63. of parameters into Patchit.  The parameter
  64. sets determine all aspects of how the
  65. stimulus will be generated and how the
  66. data will be recorded.  Parameters are
  67. stored in files called "parameter files".
  68. If there are parameter files in the current
  69. directory, a selection box will pop up
  70. showing the available parameter files.
  71. eoh
  72.  
  73. hs:2:1:List Files
  74. boh
  75.   All files with the extension ".prm" in
  76. the current directory will be shown.
  77. A parameter file may be cursor selected
  78. from this box or else the name of a
  79. parameter file may be typed in (do not
  80. type the ".prm" extension).  To change
  81. directories, type the F2 key (or else
  82. click the left mouse button in the upper
  83. window) and then type the name of the
  84. desired directory.  The list of parameter
  85. files will be updated for this new directory.
  86. eoh
  87.  
  88. ------------------- Write Parameters ------------------
  89. hs:1:2:Write Parameters
  90. boh
  91.   This allows you to store the current
  92. parameter set to a file.  The name of
  93. the parameter file should be typed
  94. without the extension ".prm" (this is
  95. automatically appended by the program).
  96. eoh
  97.  
  98. ------------------- Save Data File ------------------
  99. hs:1:3:Save Data File
  100. boh
  101.   This allows you to save the latest
  102. set of data that has been recorded.
  103. When the data is saved, a complete
  104. copy of the parameters used to record
  105. this data is also stored along with it.
  106. You must use this option to save the
  107. data that you have just recorded.  If
  108. you do not, then the data recorded by
  109. Patchit will be overwritten the next
  110. time you acquire data with Patchit.
  111. The only exception to this is if you
  112. have configured Patchit to record data
  113. directly to your disk (see below,
  114. File:Options:Record to Disk).
  115. eoh
  116.  
  117. ------------------- Options ------------------
  118. hs:1:4:Options
  119. boh
  120.   This allows you to control several
  121. very important aspects of Patchit's
  122. operation.
  123. eoh
  124.  
  125. hs:2:1:Record to Disk
  126. boh
  127.   When this feature is enabled, Patchit
  128. will store each record as it is acquired
  129. to a disk file.  Patchit will prompt the
  130. user for the name of this file when the
  131. user initially starts sampling data.
  132. Patchit will check prior to writing each
  133. record to disk that there is sufficient
  134. disk space available, and warn the user
  135. if there is not.
  136. eoh
  137.  
  138. hs:2:2:Comments in Files
  139. boh
  140.   When this feature is enabled, Patchit
  141. will prompt the user for a comment before
  142. saving a file to disk.  The comment can
  143. be of any length and is useful for
  144. recording pertinent facts about the data.
  145. eoh
  146.  
  147. hs:2:3:Okay
  148. boh
  149.   Selecting this causes any changes that
  150. you have made to the state of Record to
  151. Disk and Comments in Files to be saved.
  152. eoh
  153.  
  154. hs:2:4:Cancel
  155. boh
  156.   Selecting this causes any changes that
  157. you have made to the state of Record to
  158. Disk and Comments in Files to be discarded.
  159. eoh
  160.  
  161. ------------------- DOS Shell ------------------
  162. hs:1:5:DOS Shell
  163. boh
  164.   This allows the user to temporarily
  165. exit to DOS to perform simple commands.
  166. In order to allow this, Patchit "spawns"
  167. a copy of the DOS command interpreter.
  168. Note that Patchit is still loaded in
  169. memory so there will be less DOS memory
  170. available to execute a command.
  171. Type "EXIT" at the DOS command line
  172. ("C:\>") to return to Patchit.
  173. eoh
  174.  
  175. ------------------- About ------------------
  176. hs:1:6:About
  177. boh
  178.   Displays information about Patchit.
  179. This includes memory usage and
  180. information about the author.
  181. eoh
  182.  
  183. hs:2:1:Patchit
  184. boh
  185.   Displays information about Patchit and
  186. it's author.  Mainly this is for the
  187. copyright notice and to show you where
  188. you can reach me, to complain about things,
  189. request features or to heap praise and money.
  190. eoh
  191.  
  192. hs:2:2:Memory
  193. boh
  194.   This displays information about the
  195. memory available and in use by Patchit.
  196. There are three types of memory used
  197. by Patchit:
  198.   Conventional Memory:  This is the
  199. memory used by all DOS real mode programs,
  200. it is limited to a maximum of 640 KB.
  201. Patchit will show you the total amount
  202. of conventional memory on your computer
  203. and the amount that is currently available.
  204.   XMS Memory:  This is memory above the
  205. 1 Megabyte boundary that can be accessed
  206. by Patchit if an XMS driver (such as
  207. Microsoft's HIMEM.SYS) is loaded.  XMS
  208. memory allows Patchit to store a great
  209. deal of data without filling up the DOS
  210. (conventional) memory area.  If XMS is
  211. available Patchit will store acquired
  212. data in it unless you have disabled this
  213. feature (see below,
  214. Config:Other Options:XMS Data Storage).
  215.   Disk Memory: This is the memory available
  216. on the disk.  Patchit shows the total disk
  217. space and the available amount on the
  218. current disk.
  219. eoh
  220.  
  221. hs:2:3:Okay
  222. boh
  223.   Exits this menu
  224. eoh
  225.  
  226. ------------------- Quit ------------------
  227. hs:1:7:Quit
  228. boh
  229.   This allows you to exit the program.
  230. eoh
  231.  
  232. ------------------- Display ------------------
  233. hs:0:2:Display
  234. boh
  235. Display Menu:
  236.   - Clr Scrn   - Clears the Data Display Area
  237.   - Refresh    - Redisplays Acquired Data on Screen
  238.   - Parameters - Shows some of the parameters in Use
  239.   - Windows    - Configures the number and layout
  240.                   of data display windows
  241. eoh
  242.  
  243. ------------------- Clear Screen ------------------
  244. hs:1:1:Clear Screen
  245. boh
  246.   This allows the user to
  247. clear the data display area
  248. eoh
  249.  
  250. ------------------- Refresh ------------------
  251. hs:1:2:Refresh
  252. boh
  253.   When this is selected any data that
  254. has been recorded by Patchit will be
  255. redisplayed in the data display area.
  256. Data recorded on channels that have
  257. not been enabled for display will not
  258. be displayed.
  259. eoh
  260.  
  261. ------------------- Parameters ------------------
  262. hs:1:3:Parameters
  263. boh
  264.   When this is selected the user can
  265. see some of the currently selected
  266. parameters.  This does not show all
  267. of the parameters in effect and is in
  268. need of work.
  269. eoh
  270.  
  271. ------------------- Windows ------------------
  272. hs:1:4:Windows
  273. boh
  274.   This allows the user to configure
  275. the number and orientation of the
  276. display windows that will subdivide
  277. the data display area.  up to four
  278. such windows may be used.  If only
  279. one is used, that will fill the
  280. entire data display area.
  281.   Windows are number in ascending
  282. order from left to right and top to
  283. bottom.
  284.   NOTE:  If the user decreases the
  285. number of windows, then any data
  286. that was configured to have been
  287. displayed in a window that no longer
  288. exists (greater than the number of
  289. windows) will be displayed in window 1.
  290. eoh
  291.  
  292. hs:2:1:Number
  293. boh
  294.   The user is prompted for the number
  295. of display windows to put in the data
  296. display area.  Up to four such windows
  297. may be used.  If more than one is
  298. selected the screen will clear and the
  299. user will be allowed to determine the
  300. layout of these windows.
  301.   Windows are number in ascending
  302. order from left to right and top to
  303. bottom.
  304.   NOTE:  If the user decreases the
  305. number of windows, then any data
  306. that was configured to have been
  307. displayed in a window that no longer
  308. exists (greater than the number of
  309. windows) will be displayed in window 1.
  310. eoh
  311.  
  312. hs:2:2:Layout
  313. boh
  314.   This allows the user to determine
  315. the layout of the display windows
  316. that subdivide the data display area.
  317. The lines in the data display area
  318. show the limits of these windows.
  319. They may be moved about with the
  320. cursor keys or mouse.  Typing the
  321. space bar causes the layout/orientation
  322. of the windows to be changed.  When you
  323. are satisfied with the layout, hit the
  324. Enter key.
  325. eoh
  326.  
  327. ------------------- Sample ------------------
  328. hs:0:3:Sample
  329. boh
  330. Sample Menu:
  331.   - Go            - Begins data acquisition
  332.   - Continue      - Continues data acquisition
  333.   - Num Records   - Set the number of records
  334.                      you wish to acquire
  335.   - Length of Rec - Set the length of the data
  336.                      records
  337.   - Clock Period  - Set the Sampling Rate
  338.   - Delay Time    - Set the delay time (between)
  339.                      data acquisition cycles
  340.   - Inputs        - Configure the Inputs
  341.   - Outputs       - Configure the Outputs
  342.   - Stimulus      - Design the Output Stimulus
  343.                      Waveform(s)
  344. eoh
  345.  
  346. ------------------- Go ------------------
  347. hs:1:1:Go
  348. boh
  349.   When this is selected Patchit will
  350. acquire data.  Stimuli will be generated
  351. on any enabled output channels and data
  352. will be acquired on any enabled input
  353. channels.  Simultaneously.  This process
  354. may be interrupted by hitting a key.
  355. eoh
  356.  
  357. ------------------- Continue ------------------
  358. hs:1:2:Continue
  359. boh
  360.   When this is selected Patchit will
  361. continue acquiring data from the record
  362. where it had been before being interrupted
  363. by a keystroke.  The user has the option
  364. to continue from a record earlier than
  365. where the data acquisition cycle was
  366. interrupted.  That is, if you interrupted
  367. at recording 8 because of a big glitch in
  368. the recording (due to a power line spike
  369. of course) you could continue recording
  370. at recording 6, overwriting records 6-8
  371. with new data.
  372. eoh
  373.  
  374. ------------------- Num Records ------------------
  375. hs:1:3:Num Records
  376. boh
  377.   This allows the user to set the number of
  378. records of data to record.  Patchit records
  379. data in blocks called "records".  Each record
  380. can contain multiple channels of data.  The
  381. number of records is limited to ~64000, but
  382. is effectively limited by memory.  If you
  383. select a value for which there is insufficient
  384. memory available, Patchit will complain and
  385. reset the value.  If you need to record such
  386. large amounts of data, enable
  387. File:Options:Record To Disk.
  388. eoh
  389.  
  390. ------------------- Length of Rec ------------------
  391. hs:1:4:Length of Rec
  392. boh
  393.   This allows the user to set the length of a
  394. record (in milliseconds).  Each record is limited
  395. in size to a maximum of ~32000 points.  The
  396. number of points is equal to ((the number of input
  397. channels) * (the length of the record)) / (the sampling
  398. rate).  The number of points in the block is shown
  399. under Display:Parameters.  If you choose a value
  400. for the length of the record that exceeds the maximum
  401. number of points allowable, or the amount of memory
  402. available, Patchit will complain and reset this value.
  403. You will need to choose a shorter record length, a
  404. greater sampling interval or fewer channels of input.
  405. eoh
  406.  
  407. ------------------- Clock Period ------------------
  408. hs:1:5:Clock Period
  409. boh
  410.   This allows the user to set the sampling interval
  411. at which to record data (in milliseconds).  This
  412. value plays a role in determining the size of the
  413. record and is limited (see Length of Record, above).
  414. If you choose too small a value, Patchit will
  415. complain and reset the value.  If this happens,
  416. choose a larger value, decrease the record length
  417. or decrease the number of input channels.
  418.   NOTE:  Due to the design of certain data acquisition
  419. boards, under certain conditions Patchit may use a
  420. smaller sampling interval than you have selected.
  421. This should not affect the size of the memory block
  422. described above, but the sampling interval could be
  423. smaller than the board could handle.  This could
  424. cause the program to lock up, a full computer reboot
  425. might then be necessary.  Always test your parameter
  426. files before using them for critical recording
  427. sessions!
  428. eoh
  429.  
  430.  
  431. ------------------- Delay Time ------------------
  432. hs:1:6:Delay Time
  433. boh
  434.   This allows the user to set the delay time (in
  435. seconds) between recording sessions.  This value
  436. is the amount of time the program waits between
  437. each record.  During data acquisition cycles, this
  438. value is counted down on the screen.  A value of 0
  439. will NOT cause the records to be acquired
  440. immediately after each other.  There is a small
  441. amount of overhead time that Patchit requires
  442. between each data acquisition cycle.
  443. eoh
  444.  
  445. ------------------- Outputs ------------------
  446. hs:1:7:Outputs
  447. boh
  448.   When this is selected a menu appears allowing
  449. the user to control aspects of the channels of
  450. output available for use during data acquisition
  451. cycles.  The items on this menu correspond to
  452. the available output channels (up to 15 analog
  453. outputs (D/A converters) and one binary output
  454. consisting of 14 separate TTL outputs, depending
  455. on your data acquisition card).  Selecting one
  456. of the outputs from this menu allows you to
  457. control aspects of this output, and importantly,
  458. whether this output is enabled.  An output will
  459. only be used during a data acquisition cycle if
  460. it is enabled here.  Outputs waveforms are
  461. described on the Sample:Stimulus menu, below.
  462. The values on the right side of this menu
  463. describe some of the settings in effect for that
  464. output.  For analog outputs ("X Output X"), the
  465. enabled/disabled state of the output is shown,
  466. and the default (holding) voltage on that output.
  467. For binary outputs, the enabled/disabled state
  468. of the output is shown, and the default binary
  469. output, shown in hexadecimal.  This corresponds
  470. to the binary state of the 14 individual TTL
  471. outputs.
  472. eoh
  473.  
  474. hs:2:1:Output 0
  475. hs:2:2:Output 1
  476. boh
  477.   Selecting this item, allows the user to
  478. control aspects of this analog outut (D/A
  479. converter).  This output will only be
  480. used during data acquisition if it is
  481. enabled here.  The values on the right
  482. side of this menu describe some of the
  483. settings in effect for this output.
  484. The enabled/disabled state of the output
  485. is shown, as well as the default (holding)
  486. voltage on this output.
  487. eoh
  488.  
  489. hs:3:1:Use Channel
  490. boh
  491.   Selecting this toggles the
  492. enabled/disabled state of this
  493. output.  An output will only
  494. be used during a data acquisition
  495. cycle if it is enabled here.
  496. eoh
  497.  
  498. hs:3:2:V Hold (Vh)
  499. boh
  500.   This allows the user to set the default
  501. (holding) voltage on this output.  The
  502. voltage is specified in millivolts and is
  503. emitted on this output at all times except
  504. during data acquisition (if this channel
  505. is enabled for output).  Note that values
  506. entered for the stimulus descriptors (see
  507. below, Sample:Stimulus:D/A Channel X) are
  508. entered as absolute values and are not
  509. relative to this holding potential.
  510. eoh
  511.  
  512. hs:3:3:Attenuation
  513. boh
  514.   This allows the user to set the attenuation
  515. factor for the analog output.  This value
  516. allows Patchit to correctly set it's analog
  517. outputs to the proper values which correspond
  518. to those needed at the external hardware (e.g.
  519. an amplifier).  The value entered here is the
  520. factor by which Patchit's output will be
  521. divided in order to compensate for any
  522. attenuation or amplification at the external
  523. hardware.  For the Dagan model 8900 amplifier
  524. which has a command potential input which can
  525. be scaled by -10:1 or -20:1, the value entered
  526. into Patchit would be -10 or -20 for these two
  527. scale factors, respectively.  Generally you
  528. should use the attenuation factor you can get
  529. away with in order to scale down any noise
  530. which might enter your amplifier riding on the
  531. command voltage.  Using the-20:1 attenuation
  532. factor (in this case) will yield an effective
  533. command voltage range at the amplifier of +/-
  534. 500 mV (for D/A converters with a range of +/-
  535. 10 V from the data acquisition board divided
  536. by 20).  This value is critical and MUST be
  537. properly set in order for Patchit to output
  538. accurate voltages.
  539. eoh
  540.  
  541. hs:3:4:Okay
  542. boh
  543.   Selecting this causes any changes that
  544. you have made to the state of this analog
  545. output to be saved.
  546. eoh
  547.  
  548. hs:3:5:Cancel
  549. boh
  550.   Selecting this causes any changes that
  551. you have made to the state of this analog
  552. output to be discarded.
  553. eoh
  554.  
  555. hs:2:3:Binary Output
  556. boh
  557.   Selecting this item, allows the user to
  558. control aspects of the binary output.
  559. This output consists of 14 separate TTL
  560. outputs (depending on your data acq. card).
  561. The binary output will only be used during
  562. data acquisition if it is enabled here.
  563. The right side of this menu shows whether
  564. this output is enabled or disabled, and
  565. the default binary output, which is shown
  566. in hexadecimal.  This 14 bit hexadecimal
  567. value corresponds to the binary state of
  568. the 14 individual TTL outputs.
  569. eoh
  570.  
  571. hs:3:1:Use Channel
  572. boh
  573.   Selecting this toggles the
  574. enabled/disabled state of the
  575. binary outputs.  The binary
  576. outputs will only be used
  577. during a data acquisition
  578. cycle if it is enabled here.
  579. eoh
  580.  
  581. hs:3:2:Default Outs
  582. boh
  583.   This allows the user to set the default
  584. binary outputs.  This value is expressed
  585. as a 14 bit hexadecimal value.  With each
  586. bit corresponding to the default logic
  587. state of the 14 binary output channels.
  588. For most cases these outputs will be zero
  589. (0) unless you have a device whose trigger
  590. uses negative logic (i.e. a falling edge
  591. trigger).
  592. eoh
  593.  
  594. hs:3:3:Okay
  595. boh
  596.   Selecting this causes any changes
  597. that you have made to the state of
  598. the binary outputs to be saved.
  599. eoh
  600.  
  601. hs:3:4:Cancel
  602. boh
  603.   Selecting this causes any changes
  604. that you have made to the state of
  605. the binary outputs to be discarded.
  606. eoh
  607.  
  608. hs:2:4:Okay
  609. boh
  610.   Selecting this causes any changes
  611. that you have made to the state of
  612. the outputs to be saved.
  613. eoh
  614.  
  615. hs:2:5:Cancel
  616. boh
  617.   Selecting this causes any changes
  618. that you have made to the state of
  619. the outputs to be discarded.
  620. eoh
  621.  
  622. ------------------- Inputs ------------------
  623. hs:1:8:Inputs
  624. boh
  625.   This menu allows the user to control aspects
  626. of the channels of input used during the data
  627. acquisition cycles.  The items on this menu
  628. correspond to the available input channels
  629. (up to 16, depending on your data acquisition
  630. card).
  631.   NOTE:  Due to the design of certain data
  632. acquisition boards, under certain conditions
  633. Patchit may have to temporarily use more input
  634. channels than you have selected.  These
  635. unwanted channels will be stripped away once
  636. the data has been recorded, but can have two
  637. effects.  1) The amount of memory available
  638. for a data acquisition cycle may be reduced.
  639. 2) The increased number of channels may cause
  640. the sampling interval used to be smaller than
  641. you have selected.  This sampling interval
  642. could be smaller than the board could handle.
  643. This could cause the program to lock up, a full
  644. computer reboot might then be necessary.  Always
  645. test your parameter files before using them
  646. for critical recording sessions!
  647. eoh
  648.  
  649. hs:2:1:Input 0
  650. hs:2:2:Input 1
  651. hs:2:3:Input 2
  652. hs:2:4:Input 3
  653. hs:2:5:Input 4
  654. hs:2:6:Input 5
  655. hs:2:7:Input 6
  656. hs:2:8:Input 7
  657. hs:2:9:Input 8
  658. hs:2:10:Input 9
  659. hs:2:11:Input 10
  660. hs:2:12:Input 11
  661. hs:2:13:Input 12
  662. hs:2:14:Input 13
  663. hs:2:15:Input 14
  664. hs:2:16:Input 15
  665. boh
  666.   This menu allows the user to control aspects
  667. of this input channel.  Selecting this option
  668. allows you to control aspects of this input,
  669. and importantly, whether this input is enabled.
  670. During data acquisition, data will only be
  671. recorded on an input if it is enabled here.
  672. The values on the right side of this menu
  673. describe some of the settings in effect for this
  674. input.  The enabled/disabled state of the input
  675. is shown, and if enabled, a code is shown which
  676. summarizes the display options for this input.
  677. There are five characters between parentheses,
  678. they are, in order: 'D':data will be displayed.
  679. '1',2','3' or '4': The window in which the data
  680. will be displayed.  '^': the data will be
  681. displayed inverted.  '*': the displayed data will
  682. be scaled (multiplied) by some factor.  '+': the
  683. displayed data will be vertically offset by some
  684. factor.  If any of these display options are not
  685. in effect, the corresponding character will not
  686. be shown.
  687.   NOTE:  Due to the design of certain data
  688. acquisition boards, under certain conditions
  689. Patchit may have to temporarily use more input
  690. channels than you have selected.  These
  691. unwanted channels will be stripped away once
  692. the data has been recorded, but can have two
  693. effects.  1) The amount of memory available
  694. for a data acquisition cycle may be reduced.
  695. 2) The increased number of channels may cause
  696. the sampling interval used to be smaller than
  697. you have selected.  This sampling interval
  698. could be smaller than the board could handle.
  699. This could cause the program to lock up, a full
  700. computer reboot might then be necessary.  Always
  701. test your parameter files before using them
  702. for critical recording sessions!
  703. eoh
  704.  
  705. hs:3:1:Recording
  706. boh
  707.   Selecting this toggles the enabled/disabled
  708. state of this intput.  Data will be recorded
  709. on an input during a data acquisition cycle
  710. only if it is enabled here.  Enabling/disabling
  711. an input will also automatically turn on
  712. display of this data - you can turn this off below.
  713. eoh
  714.  
  715. hs:3:2:Type
  716. boh
  717.   This allows the user to set the type of data
  718. that is on this channel.  This can be set to
  719. indicate that the data represents either
  720. current or voltage.
  721. eoh
  722.  
  723. hs:3:3:Gain
  724. boh
  725.   Selecting this allows the user to set how
  726. Patchit will handle the gain for this data.
  727. Four options are available.
  728.   Not Set in Patchit:  Selecting this indicates
  729. that the gain will not be set in Patchit for
  730. this data.  If this is set for this channel
  731. and the data is saved to a file and loaded
  732. into Tack, Tack will prompt you then and
  733. there for the gain.
  734.   Set Gain Right Now:  Selecting this causes
  735. Patchit to prompt you for the gain right now.
  736. This gain mode is best suited for circumstances
  737. in which the gain on an input is not likely to
  738. vary often.
  739.   Prompt for Later:  Selecting this causes
  740. Patchit to prompt you for the gain on this
  741. input channel when the data is saved to file.
  742. This gain mode is best suited for circumstances
  743. in which the gain might change frequently.
  744.   Read from A/D Chan:  Selecting this causes a
  745. box to appear and for Patchit to prompt you
  746. for the A/D channel from which automatic gain
  747. recordings will be made.  This is presently
  748. hard-configured for my Dagan 8900 amplifier.
  749. It has 7 gain settings -1000, -500, -200,
  750. -100, -50, -20, -10 (with the 1G headstage)
  751. - these 7 gains generate a signal of 0.5,
  752. 1.0, 1.5, 2.0, 2.5, 3.0 and 3.5 Volts on
  753. the gain output.  When this gain mode is active,
  754. Patchit will read the voltage from the selected
  755. A/D gain channel prior to each data acquisition
  756. cycle.  This gain mode is best suited for
  757. amplifiers which have an automatic gain sender
  758. unit.
  759. eoh
  760.  
  761. hs:3:4:Display
  762. boh
  763.   Selecting this toggles the enabled/disabled
  764. state for whether or not data on this channel
  765. will be displayed.  Data can only be displayed
  766. if this channel is enabled for input.
  767. eoh
  768.  
  769. hs:3:5:Window
  770. boh
  771.   Selecting this allows the user to select in
  772. which of up to four windows this data will be
  773. displayed in.  If more than one such window
  774. is available then the user will be prompted
  775. for which window to display the data in.
  776. Windows are set up using Display:Windows,
  777. above.
  778.   NOTE:  If data on a given channel is
  779. configured to be displayed in a given channel,
  780. and the user then decreases the number of
  781. windows (see Display:Windows), then any data
  782. that was to have been displayed in a window
  783. that no longer exists (greater than the number
  784. of windows) will be displayed in window 1.
  785. eoh
  786.  
  787. hs:3:6:Invert
  788. boh
  789.   Selecting this toggles the enabled/disabled
  790. state for whether or not data on this channel
  791. will be displayed inverted (upside-down).
  792. This feature has been implemented for amplifiers
  793. (such as the Dagan 8900) that have a signal that
  794. is inverted (i.e. upside-down) relative to the
  795. desired convention for that signal.  If a
  796. channel of data is configured to be displayed
  797. inverted, then ONLY the display of this data
  798. will be inverted.  The raw data is recorded as
  799. it is sampled from the analog signal.  If you
  800. need to invert a channel for display, then the
  801. gain at which this data was recorded should be
  802. a negative value.
  803. eoh
  804.  
  805. hs:3:7:Scale Factor
  806. boh
  807.   This allows the user to enter a value by which
  808. the displayed data will be scaled (multiplied by).
  809. This value affects only the display of the data,
  810. the raw data is unaffected.  Inverting the display
  811. of a channel can be set here by setting this value
  812. to -1, but toggling the invert flag would cause
  813. the display to be faster.
  814. eoh
  815.  
  816. hs:3:8:Offset
  817. boh
  818.   This allows the user to enter a value by which
  819. the displayed data will be offset vertically
  820. (added to).  This value is entered as a value in
  821. the range +1.0 to -1.0, +1.0 causes the data to
  822. be drawn at the top of the display, -1.0 causes
  823. the data to be drawn at the bottom of the display,
  824. 0.0 causes the data to be drawn as it is recorded.
  825. Intermediate values cause intermediate effects.
  826. This value affects only the display of the data,
  827. the raw data is unaffected.
  828. eoh
  829.  
  830. hs:3:9:Okay
  831. boh
  832.   Selecting this causes any changes
  833. that you have made to the state of
  834. this input to be saved.
  835. eoh
  836.  
  837. hs:3:10:Cancel
  838. boh
  839.   Selecting this causes any changes
  840. that you have made to the state of
  841. this input to be discarded.
  842. eoh
  843.  
  844. hs:2:17:Okay
  845. boh
  846.   Selecting this causes any changes
  847. that you have made to the state of
  848. the inputs to be saved.
  849. eoh
  850.  
  851. hs:2:18:Cancel
  852. boh
  853.   Selecting this causes any changes
  854. that you have made to the state of
  855. the inputs to be discarded.
  856. eoh
  857.  
  858. ------------------- Stimulus ------------------
  859. hs:1:9:Stimulus
  860. boh
  861.   This option allows the user to control the
  862. stimulus waveforms generated on the various output
  863. channels during a data acquisition cycle.  There
  864. are two different types of outputs, analog (D/A)
  865. and binary (TTL).  The stimuli that can be
  866. generated on these channels are different.
  867. Selecting one of the options on this menu
  868. causes a menu to pop up under which you can
  869. describe the format of the output waveform on the
  870. selected output channel.  If the output channel
  871. is not enabled for the channel on which you are
  872. describing the output, you will be warned.
  873. eoh
  874.  
  875. hs:2:1:D/A Output 0
  876. hs:2:2:D/A Output 1
  877. boh
  878.   Selecting this option allows the user to
  879. control the stimulus generated on the selected
  880. analog output during a data acquisition cycle.
  881. If the output channel is not enabled for output
  882. you will be warned.
  883. eoh
  884.  
  885. hs:3:1:Add Event
  886. boh
  887.   This allows you to add an event to the event
  888. list and thus in the output waveform on this
  889. channel.  The event will be added to the event
  890. list in its proper chronological order.
  891.   Output waveforms are described by a series
  892. of events which occur at specific times during
  893. the data acquisition cycle.  Existing events
  894. occurring on this output are listed in
  895. chronological order, in the box shown at the
  896. bottom of the screen.  Events may be added,
  897. changed or deleted from this list using the
  898. menu.  Events are described by event descriptors.
  899. eoh
  900.  
  901. hs:4:1:Format
  902. boh
  903.   An event can be either a step or a ramp.
  904. A step is an instantaneous (well, as good
  905. as the hardware can do) change in the output
  906. state at the given time.  A ramp causes the
  907. output to change state in a linear or ramp
  908. -like fashion starting at some given time.
  909. The next two items on this menu differ
  910. depending upon the format selected here
  911. eoh
  912.  
  913. hs:4:2:Level
  914. boh
  915.   For Step Events, this is the voltage
  916. (in millivolts) to which the output is
  917. stepped at the time of the event.
  918.   For Ramp events, this is the voltage
  919. (in millivolts) at which the ramp
  920. starts at the time of the event.
  921. eoh
  922.  
  923. hs:4:3:Incmt/Slope
  924. boh
  925.   For Step Events, this is the voltage
  926. increment (in millivolts) by which the
  927. output voltage is changed during each
  928. successive data acquisition cycle
  929. (record).
  930.   For Ramp Events, this is the slope
  931. (in millivolts/millisecond) of the ramp.
  932. eoh
  933.  
  934. hs:4:4:Time
  935. boh
  936.   The time (in milliseconds) at
  937. which the event is to occur.
  938. eoh
  939.  
  940. hs:4:5:Delta T
  941. boh
  942.   The increment (in milliseconds)
  943. by which the time of the event is
  944. shifted during each successive
  945. data acquisition cycle.
  946. eoh
  947.  
  948. hs:4:6:Okay
  949. boh
  950.   This causes any changes that you
  951. have made to this event to be saved.
  952. eoh
  953.  
  954. hs:4:7:Cancel
  955. boh
  956.   This causes any changes that you
  957. have made to this event to be discarded.
  958. eoh
  959.  
  960. hs:3:2:Change Event
  961. boh
  962.   This allows you to change an event in the
  963. event list and thus in the output waveform
  964. on this channel.  The revised event will be
  965. added to the event list in its proper
  966. chronological order.  You will be prompted
  967. for which event you wish to change.
  968.   Output waveforms are described by a series
  969. of events which occur at specific times during
  970. the data acquisition cycle.  Existing events
  971. occurring on this output are listed in
  972. chronological order, in the box shown at the
  973. bottom of the screen.  Events may be added,
  974. changed or deleted from this list using the
  975. menu.  Events are described by event descriptors.
  976. eoh
  977.  
  978. hs:4:1:Format
  979. boh
  980.   An event can be either a step or a ramp.
  981. A step is an instantaneous (well, as good
  982. as the hardware can do) change in the output
  983. state at the given time.  A ramp causes the
  984. output to change state in a linear or ramp
  985. -like fashion starting at some given time.
  986. The next two items on this menu differ
  987. depending upon the format selected here
  988. eoh
  989.  
  990. hs:4:2:Level
  991. boh
  992.   For Step Events, this is the voltage
  993. (in millivolts) to which the output is
  994. stepped at the time of the event.
  995.   For Ramp events, this is the voltage
  996. (in millivolts) at which the ramp
  997. starts at the time of the event.
  998. eoh
  999.  
  1000. hs:4:3:Incmt/Slope
  1001. boh
  1002.   For Step Events, this is the voltage
  1003. increment (in millivolts) by which the
  1004. output voltage is changed during each
  1005. successive data acquisition cycle
  1006. (record).
  1007.   For Ramp Events, this is the slope
  1008. (in millivolts/millisecond) of the ramp.
  1009. eoh
  1010.  
  1011. hs:4:4:Time
  1012. boh
  1013.   The time (in milliseconds) at
  1014. which the event is to occur.
  1015. eoh
  1016.  
  1017. hs:4:5:Delta T
  1018. boh
  1019.   The increment (in milliseconds)
  1020. by which the time of the event is
  1021. shifted during each successive
  1022. data acquisition cycle.
  1023. eoh
  1024.  
  1025. hs:4:6:Okay
  1026. boh
  1027.   This causes any changes that you
  1028. have made to this event to be saved.
  1029. eoh
  1030.  
  1031. hs:4:7:Cancel
  1032. boh
  1033.   This causes any changes that you
  1034. have made to this event to be discarded.
  1035. eoh
  1036.  
  1037. hs:3:3:Delete Event
  1038. boh
  1039.   This allows you to delete an event
  1040. from the event list and thus from the
  1041. output waveform for this channel.  You
  1042. will be prompted for which event to delete.
  1043. eoh
  1044.  
  1045. hs:3:4:Erase All Events
  1046. boh
  1047.   This allows you to delete all events in
  1048. the event list and thus from the output
  1049. waveform for this channel.  If this channel
  1050. were still enabled for output and there were
  1051. no events on it, then the output would be
  1052. the default voltage ouput (set by
  1053. Sample:Outputs:X Output X:V Hold Vh).
  1054. eoh
  1055.  
  1056. hs:3:5:Okay
  1057. boh
  1058.   This exits the event descriptor control
  1059. menu for this output channel.
  1060. eoh
  1061.  
  1062. hs:2:3:Binary Output
  1063. boh
  1064.   Selecting this option allows the user to
  1065. control the stimulus generated on the binary
  1066. output during a data acquisition cycle.
  1067. If the binary output is not enabled you will
  1068. be warned.
  1069. eoh
  1070.  
  1071. hs:3:1:Add Event
  1072. boh
  1073.   This allows you to add an event to the event
  1074. list and thus to the binary output waveform.
  1075. The event will be added to the event list in
  1076. its proper chronological order.  You will be
  1077. prompted for which event to change.
  1078.   Output waveforms are described by a series
  1079. of events which occur at specific times during
  1080. the data acquisition cycle.  Existing events
  1081. occurring on this output are listed in
  1082. chronological order, in the box shown at the
  1083. bottom of the screen.  Events may be added,
  1084. changed or deleted from this list using the
  1085. menu.  Events are described by event descriptors.
  1086. eoh
  1087.  
  1088. hs:4:1:Hex Value
  1089. boh
  1090.   The value in hexadecimal (up to 3FFF) which
  1091. is to be output on the binary port at the time
  1092. of the event.  Each binary output is controlled
  1093. by one bit of this number.  To output the logic
  1094. level "1" on binary channel 0, the value in
  1095. hexadecimal is 1.  To output the logic level "1"
  1096. on binary channel 1, the value in hexadecimal is
  1097. 2. Oh, go look up hexadecimal numbers somewhere
  1098. else.
  1099. eoh
  1100.  
  1101. hs:4:2:Time
  1102. boh
  1103.   The time (in milliseconds) at
  1104. which the event is to occur.
  1105. eoh
  1106.  
  1107. hs:4:3:Delta T
  1108. boh
  1109.   The increment (in milliseconds)
  1110. by which the time of the event is
  1111. shifted during each successive
  1112. data acquisition cycle.
  1113. eoh
  1114.  
  1115. hs:4:4:Okay
  1116. boh
  1117.   This causes any changes that you
  1118. have made to this event to be saved.
  1119. eoh
  1120.  
  1121. hs:4:5:Cancel
  1122. boh
  1123.   This causes any changes that you
  1124. have made to this event to be discarded.
  1125. eoh
  1126.  
  1127. hs:3:2:Change Event
  1128. boh
  1129.   This allows you to change an event in the
  1130. event list and thus in the binary output
  1131. waveform.  The revised event will be added
  1132. to the event list in its proper chronological
  1133. order.  You will be prompted for which event
  1134. to change.
  1135.   Output waveforms are described by a series
  1136. of events which occur at specific times during
  1137. the data acquisition cycle.  Existing events
  1138. occurring on this output are listed in
  1139. chronological order, in the box shown at the
  1140. bottom of the screen.  Events may be added,
  1141. changed or deleted from this list using the
  1142. menu.  Events are described by event descriptors.
  1143. eoh
  1144.  
  1145. hs:4:1:Hex Value
  1146. boh
  1147.   The value in hexadecimal (up to 3FFF) which
  1148. is to be output on the binary port at the time
  1149. of the event.  Each binary output is controlled
  1150. by one bit of this number.  To output the logic
  1151. level "1" on binary channel 0, the value in
  1152. hexadecimal is 1.  To output the logic level "1"
  1153. on binary channel 1, the value in hexadecimal is
  1154. 2. Oh, go look up hexadecimal numbers somewhere
  1155. else.
  1156. eoh
  1157.  
  1158. hs:4:2:Time
  1159. boh
  1160.   The time (in milliseconds) at
  1161. which the event is to occur.
  1162. eoh
  1163.  
  1164. hs:4:3:Delta T
  1165. boh
  1166.   The increment (in milliseconds)
  1167. by which the time of the event is
  1168. shifted during each successive
  1169. data acquisition cycle.
  1170. eoh
  1171.  
  1172. hs:4:4:Okay
  1173. boh
  1174.   This causes any changes that you
  1175. have made to this event to be saved.
  1176. eoh
  1177.  
  1178. hs:4:5:Cancel
  1179. boh
  1180.   This causes any changes that you
  1181. have made to this event to be discarded.
  1182. eoh
  1183.  
  1184. hs:3:3:Delete Event
  1185. boh
  1186.   This allows you to delete an event
  1187. from the event list and thus from the
  1188. binary output waveform.  You will be
  1189. prompted for which event to delete.
  1190. eoh
  1191.  
  1192. hs:3:4:Erase All Events
  1193. boh
  1194.   This allows you to delete all events in
  1195. the event list and thus from the binary
  1196. output waveform.  If the binary output
  1197. were still enabled for output and there
  1198. were no events on it, then each
  1199. individual binary output would be set at
  1200. its default value (TTL) (set by
  1201. Sample:Outputs:Binary Output:Default Outs).
  1202. eoh
  1203.  
  1204. hs:3:5:Okay
  1205. boh
  1206.   This exits the event descriptor control
  1207. menu for the binary output channel.
  1208. eoh
  1209.  
  1210. hs:2:4:Okay
  1211. boh
  1212.   This exits the Stimulus control menu.
  1213. eoh
  1214.  
  1215. ------------------- Pulse Generator Menu ------------------
  1216. hs:0:4:Pulse_Gen
  1217. boh
  1218. Pulse Generator Menu:
  1219.   - Go            - Begins pulse generation
  1220.   - Length of Rec - Set the length of the pulse
  1221.                      generator cycle
  1222.   - Clock Period  - Set the Sampling Rate for
  1223.                      the pulse generator
  1224.   - Delay Time    - Set the delay time (between)
  1225.                      pulse generator cycles
  1226.   - Inputs        - Selects the Input used by
  1227.                      the pulse generator
  1228.   - Outputs       - Selects the Output used by
  1229.                      the pulse generator
  1230.  
  1231.   The pulse generator allows Patchit to acquire data
  1232. in a special mode.  Stimulus will be generated on
  1233. one enabled output channel and data will be acquired
  1234. on one input channel.  Simultaneously.  This process
  1235. may be interrupted by hitting the space bar or the
  1236. ESC key.  This function generates a square voltage
  1237. pulse on the selected output channel.  The pulse
  1238. width is one half of the length of the event selected
  1239. (see below).  The pulse is preceded and anteceded by
  1240. a time of one quarter of the record length selected
  1241. (i.e. the pulse has a 50% duty cycle).  While the
  1242. pulse generator is active, the menu bar displays the
  1243. amplitude of the current pulse and the range of pulse
  1244. voltages that can be selected with the function keys.
  1245. The initial amplitude of the pulse is +10 mV.  This
  1246. can be changed by using the function keys.  Pressing
  1247. any of the keys from F1 to F10 causes the amplitude
  1248. of the pulse to be changed on the next pulse to a
  1249. voltage from +10 mV to +100 mV (F1 = 10mV, F2 = 20mV,
  1250. F3 = 30mV...).  ALT, CTRL and SHIFT modify the range
  1251. of voltages that can be selected with the function
  1252. keys.  So, SHIFT-F1 through SHIFT-F10 generate pulses
  1253. from -10 mV to -100 mV.  ALT-F1 through ALT-F10
  1254. generate pulses from +50 mV to +500 mV.  CTRL-F1
  1255. through CTRL-F10 generate pulses from -50 mV to -500
  1256. mV.  Typing the "0" key causes the pulse to have an
  1257. amplitude of 0 mV.
  1258. eoh
  1259.  
  1260. ------------------- Go! ------------------
  1261. hs:1:1:Go
  1262. boh
  1263.   This starts the pulse generator mode.  In this
  1264. mode Stimulus will be generated on one enabled
  1265. output channel and data will be acquired on one
  1266. input channel.  Simultaneously.  This process
  1267. may be interrupted by hitting the space bar or the
  1268. ESC key.  This function generates a square voltage
  1269. pulse on the selected output channel.  The pulse
  1270. width is one half of the length of the event selected
  1271. (see below).  The pulse is preceded and anteceded by
  1272. a time of one quarter of the record length selected
  1273. (i.e. the pulse has a 50% duty cycle).  While the
  1274. pulse generator is active, the menu bar displays the
  1275. amplitude of the current pulse and the range of pulse
  1276. voltages that can be selected with the function keys.
  1277. The initial amplitude of the pulse is +10 mV.  This
  1278. can be changed by using the function keys.  Pressing
  1279. any of the keys from F1 to F10 causes the amplitude
  1280. of the pulse to be changed on the next pulse to a
  1281. voltage from +10 mV to +100 mV (F1 = 10mV, F2 = 20mV,
  1282. F3 = 30mV...).  ALT, CTRL and SHIFT modify the range
  1283. of voltages that can be selected with the function
  1284. keys.  So, SHIFT-F1 through SHIFT-F10 generate pulses
  1285. from -10 mV to -100 mV.  ALT-F1 through ALT-F10
  1286. generate pulses from +50 mV to +500 mV.  CTRL-F1
  1287. through CTRL-F10 generate pulses from -50 mV to -500
  1288. mV.  Typing the "0" key causes the pulse to have an
  1289. amplitude of 0 mV.
  1290. eoh
  1291.  
  1292. ------------------- Length of Rec ------------------
  1293. hs:1:2:Length of Rec
  1294. boh
  1295.   This allows the user to set the length of a "record"
  1296. in milliseconds.  This determines the duration of each
  1297. pulse generator cycle.  The pulse width is one half of
  1298. this duration.  The data that is sampled by the pulse
  1299. generator is read in records.  Each record is limited
  1300. in size to a maximum of ~32000 points.  The number of
  1301. points is equal to (the length of the record) / (the
  1302. sampling rate).  If you choose a value for the length
  1303. of a pulse generator cycle that exceeds the maximum
  1304. number of points or amount of memory, Patchit will
  1305. complain and reset this value.  You will need to
  1306. choose a shorter event length or a greater sampling
  1307. interval.
  1308. eoh
  1309.  
  1310. ------------------- Clock Period ------------------
  1311. hs:1:3:Clock Period
  1312. boh
  1313.   This allows the user to set the sampling interval at
  1314. which to record data (in milliseconds).  This value
  1315. plays a role in the size of the memory block allocated
  1316. and is limited (see Length of Record, above).  If you
  1317. choose too small a value, Patchit will complain and
  1318. reset the value, so choose a larger value or decrease
  1319. the length of the pulse generator cycle.
  1320.   NOTE:  Due to the design of certain data acquisition
  1321. boards, under certain conditions Patchit may use a
  1322. smaller sampling interval than you have selected.
  1323. This should not affect the size of the memory block
  1324. described above, but the sampling interval could be
  1325. smaller than the board could handle.  This could cause
  1326. the program to lock up, a full computer reboot might
  1327. then be necessary.  Always test your parameter files
  1328. before using them for critical recording sessions!
  1329. eoh
  1330.  
  1331. ------------------- Delay Time ------------------
  1332. hs:1:4:Delay Time
  1333. boh
  1334.   This allows the user to set the delay time (in
  1335. seconds) between pulse generator cycles.  This
  1336. value is the amount of time the program waits
  1337. between each cycle.  A value of 0 here will NOT
  1338. cause the records to be acquired immediately after
  1339. each other.  There is a small amount of overhead
  1340. time that Patchit requires between each pulse
  1341. generator cycle.
  1342. eoh
  1343.  
  1344. ------------------- Output Channel ------------------
  1345. hs:1:5:Output Channel
  1346. boh
  1347.   This allows the user to set the analog output
  1348. channel that will be used for output.  It is on
  1349. this channel that the voltage pulse will be
  1350. generated when Pulse Generator:Go is selected.
  1351. eoh
  1352.  
  1353. ------------------- Input Channel ------------------
  1354. hs:1:6:Input Channel
  1355. boh
  1356.   This allows the user to set the analog input
  1357. channel that will be used for input.  It is on
  1358. this channel that analog data from the experimental
  1359. preparation will be acquired and displayed.
  1360.   NOTE:  Due to the design of certain data acquisition
  1361. boards, under certain conditions Patchit may have to
  1362. temporarily use more input channels than you have
  1363. selected.  These unwanted channels will be stripped
  1364. away once the data has been recorded, but can have
  1365. two effects.  1) The amount of memory available for
  1366. a pulse generator cycle may be reduced.  2) The
  1367. increased number of channels may cause the sampling
  1368. interval used to be smaller than you have selected.
  1369. This sampling interval could be smaller than the
  1370. board could handle.  This could cause the program to
  1371. lock up, a full computer reboot might then be
  1372. necessary.  Always test your parameter files before
  1373. using them for critical recording sessions!
  1374. eoh
  1375.  
  1376. ------------------- Config Menu ------------------
  1377. hs:0:5:Config
  1378. boh
  1379. Config Menu:
  1380.   - Hardware Config   - Select the type of data
  1381.                          acquisition hardware installed
  1382.   - Graphics Display  - Select the graphics display
  1383.                          adapter & resolution
  1384.   - Colors            - Select the colors of Patchit's
  1385.                          Screen components
  1386.   - Font              - Select the font used by Patchit
  1387.   - Sounds            - Configure sound generation
  1388.   - Display Options   - Set certain options about the
  1389.                          display of data
  1390.   - Other Options     - Set several other options
  1391.   - Write Config File - Save the current configuration
  1392.                          to file
  1393. eoh
  1394.  
  1395. ------------------- Hardware Config ------------------
  1396. hs:1:1:Hardware Config
  1397. boh
  1398.   This allows the user to specify the type of data
  1399. acquisition hardware in use and its configuration.
  1400. When this is selected a menu appears and the user
  1401. can select among the data acquisition hardware that
  1402. Patchit supports.  At present there are two families
  1403. of boards that are supported, the Data Translation
  1404. DT2821 series and the Tecmar Labmaster series. There
  1405. is also the option of selecting "No Board" in which
  1406. case you can try out Patchit on a computer that has
  1407. no data acquisition card loaded.  When one of these
  1408. board families is selected, another menu appears
  1409. from which the user can select the specific type of
  1410. board he or she is using, the base address of the
  1411. board, DMA channel(s), interrupt channel, and trigger
  1412. source.
  1413. eoh
  1414.  
  1415. hs:2:1:No Board
  1416. boh
  1417.   This selects a hardware configuration for a
  1418. computer with no data acquisition hardware
  1419. installed.  If you enable one input and one
  1420. output, then data from the output will be
  1421. copied to the input channel.  This is a little
  1422. flaky.
  1423. eoh
  1424.  
  1425. hs:3:1:Family Member
  1426. boh
  1427.   There is only one family member for the
  1428. No Board Family of boards
  1429. eoh
  1430.  
  1431. hs:3:2:Okay
  1432. boh
  1433.   Selecting this causes any changes that you
  1434. have made to the configuration for the data
  1435. acquisition hardware to be saved.
  1436. eoh
  1437.  
  1438. hs:3:3:Cancel
  1439. boh
  1440.   Selecting this causes any changes that you
  1441. have made to the configuration for the data
  1442. acquisition hardware to be discarded.
  1443. eoh
  1444.  
  1445. hs:2:2:Data Translation DT2821
  1446. boh
  1447.   This selects a board from the the Data
  1448. Translation DT2821 family of data acquisition
  1449. cards as your data acquisition board.
  1450. eoh
  1451.  
  1452. hs:3:1:Family Member
  1453. boh
  1454.   Select the specific data acquisition
  1455. card that you have from this menu.  This
  1456. selection allows Patchit to take advantage
  1457. of the feautres of the specific board
  1458. (i.e., number of input channels etc.).
  1459. eoh
  1460.  
  1461. hs:3:2:Base Address
  1462. boh
  1463.   Select the base address (in hexadecimal)
  1464. of the data acquisition board.  It is
  1465. imperative that this match the configuration
  1466. of the board (see your board's manual) or else
  1467. Patchit can't talk to the board.
  1468. eoh
  1469.  
  1470. hs:3:3:1st DMA Channel
  1471. boh
  1472.   Select the 1st DMA channel that the DT2821
  1473. board is set to.  The value selected here must
  1474. match the configuration of the board.
  1475. eoh
  1476.  
  1477. hs:3:4:2nd DMA Channel
  1478. boh
  1479.   Select the 2nd DMA channel that the DT2821
  1480. board is set to.  The value selected here must
  1481. match the configuration of the board.
  1482.   NOTE:  This really doesn't matter, since
  1483. Patchit doesn't use the second DMA channel.
  1484. eoh
  1485.  
  1486. hs:3:5:Interrupt
  1487. boh
  1488.   Select the Interrupt channel that the DT2821
  1489. board is set to.  The value selected here must
  1490. match the configuration of the board.
  1491.   NOTE: This really doesn't matter, since
  1492. Patchit doesn't use the Interrupt.
  1493. eoh
  1494.  
  1495. hs:3:6:Trigger Src
  1496. boh
  1497.   Select whether to use an internal trigger or
  1498. an external trigger.
  1499.   For an internal trigger,
  1500. Patchit will start its own data acquisition
  1501. cycle.  In order for this to work properly the
  1502. Binary Output 1, Channel 7 on the DT2821 series
  1503. board must be connected to the External Trigger
  1504. input on the DT2821.
  1505.   For an external trigger, a rising-edge TTL
  1506. trigger will start the data acquisition cycle.
  1507. For the DT2821 series board, this must be
  1508. applied to the external trigger input on the
  1509. DT2821.
  1510. eoh
  1511.  
  1512. hs:3:7:Okay
  1513. boh
  1514.   Selecting this causes any changes that you
  1515. have made to the configuration for the data
  1516. acquisition hardware to be saved.
  1517. eoh
  1518.  
  1519. hs:3:8:Cancel
  1520. boh
  1521.   Selecting this causes any changes that you
  1522. have made to the configuration for the data
  1523. acquisition hardware to be discarded.
  1524. eoh
  1525.  
  1526. hs:2:3:Tecmar Labmaster
  1527. boh
  1528.   This selects a board from the the Tecmar
  1529. Labmaster family of data acquisition
  1530. cards as your data acquisition board.
  1531. eoh
  1532.  
  1533. hs:3:1:Family Member
  1534. boh
  1535.   Select the specific data acquisition
  1536. card that you have from this menu.  This
  1537. selection allows Patchit to take advantage
  1538. of the feautres of the specific board
  1539. (i.e., number of input channels etc.).
  1540. eoh
  1541.  
  1542. hs:3:2:Base Address
  1543. boh
  1544.   Select the base address (in hexadecimal)
  1545. of the data acquisition board.  It is
  1546. imperative that this match the configuration
  1547. of the board (see your board's manual) or else
  1548. Patchit can't talk to the board.
  1549. eoh
  1550.  
  1551. hs:3:3:DMA Channel
  1552. boh
  1553.   Select the DMA channel that the Tecmar
  1554. Labmaster DMA is set to.  The value selected
  1555. here must match the configuration of the
  1556. board.
  1557.   NOTE:  This really doesn't matter, since
  1558. Patchit doesn't use the DMA channel on the
  1559. Labmaster DMA (yet!).
  1560. eoh
  1561.  
  1562. hs:3:4:Interrupt
  1563. boh
  1564.   Select the Interrupt channel that the Tecmar
  1565. Labmaster is set to.  The value selected here
  1566. must match the configuration of the board.
  1567.   NOTE: This really doesn't matter, since
  1568. Patchit doesn't use the Interrupt.
  1569. eoh
  1570.  
  1571. hs:3:5:A/D Format
  1572. boh
  1573.   Select whether the the data format on the
  1574. Tecmar Labmaster is set to 2's Complement
  1575. or Binary.  This value must match the
  1576. configuration of the board.  The default
  1577. format for Patchit (and Tack) is 2's complement.
  1578. eoh
  1579.  
  1580. hs:3:6:Trigger Src
  1581. boh
  1582.   Select whether to use an internal trigger or
  1583. an external trigger.
  1584.   For an internal trigger, Patchit will start
  1585. its own data acquisition cycle.
  1586.   For an external trigger, a rising-edge TTL
  1587. trigger will start the data acquisition cycle.
  1588. For a Tecmar Labmaster this trigger pulse must
  1589. be applied to the binary input port B, Bit 2
  1590. (B2).
  1591. eoh
  1592.  
  1593. hs:3:7:Okay
  1594. boh
  1595.   Selecting this causes any changes that you
  1596. have made to the configuration for the data
  1597. acquisition hardware to be saved.
  1598. eoh
  1599.  
  1600. hs:3:8:Cancel
  1601. boh
  1602.   Selecting this causes any changes that you
  1603. have made to the configuration for the data
  1604. acquisition hardware to be discarded.
  1605. eoh
  1606.  
  1607. ------------------- Graphics Display ------------------
  1608. hs:1:2:Graphics Display
  1609. boh
  1610.   This allows the user to select the type of
  1611. graphics display and display resolution that
  1612. should be used.  Normally, the graphics
  1613. autodetect setting should be used.  For a
  1614. given display type to be used, the requisite
  1615. display driver file (they have the extension
  1616. ".bgi") MUST be present in the same directory
  1617. as Patchit.
  1618. eoh
  1619.  
  1620. hs:2:1:Display Type
  1621. boh
  1622.   This allows the user to select the type of
  1623. graphics display that should be used.
  1624. Normally, the graphics autodetect setting
  1625. should be used.  For a given display type to
  1626. be used, the requisite display driver file
  1627. (they have the extension ".bgi") MUST be
  1628. present in the same directory as Patchit.
  1629. Twelve settings are available.
  1630.   NOTE:  If your computer does not support
  1631. the display type that you have selected, you
  1632. may well crash the program when you try to
  1633. switch display types.
  1634. eoh
  1635.  
  1636. hs:2:2:Resolution
  1637. boh
  1638.   This allows the user to select the display
  1639. resolution for the selected display type.
  1640. Note that some display types have only one
  1641. available resolution.
  1642. NOTE:  If your computer's display adapter
  1643. does not support the resolution that you
  1644. have selected, you may well crash the program
  1645. when you try to switch display resolutions.
  1646. eoh
  1647.  
  1648. hs:2:3:Okay
  1649. boh
  1650.   Selecting this option causes any changes
  1651. that you have made to the graphics display
  1652. type and resolution to go into effect.
  1653. eoh
  1654.  
  1655. hs:2:4:Cancel
  1656. boh
  1657.   Selecting this option causes any changes
  1658. that you have made to the graphics display
  1659. type and resolution to be cancelled.
  1660. eoh
  1661.  
  1662. ------------------- Colors ------------------
  1663. hs:1:3:Colors
  1664. boh
  1665.   Selects the colors for the elements of
  1666. the Patchit display.
  1667. eoh
  1668.  
  1669. hs:2:1:Menubar
  1670. boh
  1671.   Selects the colors for the Menu Bar
  1672. and all menus on the Patchit Display
  1673. eoh
  1674.  
  1675. hs:3:1:Back Color
  1676. boh
  1677.   Selects the background color for menus
  1678. eoh
  1679.  
  1680. hs:3:2:Text Color
  1681. boh
  1682.   Selects the color for text for menus
  1683. eoh
  1684.  
  1685. hs:3:3:Frame Color
  1686. boh
  1687.   Selects the color for the frame (border)
  1688. for menus
  1689. eoh
  1690.  
  1691. hs:3:4:Letter Color
  1692. boh
  1693.   Selects the color for the select letter
  1694. (the letter which will access the menu
  1695. item) for the menus.  This letter is also
  1696. underlined
  1697. eoh
  1698.  
  1699. hs:3:5:Okay
  1700. boh
  1701.   Exits this menu
  1702. eoh
  1703.  
  1704. hs:2:2:Status Line
  1705. boh
  1706.   Selects the colors for the Status Line
  1707. (the bottom part of the display)
  1708. eoh
  1709.  
  1710. hs:3:1:Back Color
  1711. boh
  1712.   Selects the background color for the
  1713. Status Line
  1714. eoh
  1715.  
  1716. hs:3:2:Text Color
  1717. boh
  1718.   Selects the color for text for
  1719. the Status Line
  1720. eoh
  1721.  
  1722. hs:3:3:Okay
  1723. boh
  1724.   Exits this menu
  1725. eoh
  1726.  
  1727. hs:2:3:Popup Boxes
  1728. boh
  1729.   Selects the colors for the Popup
  1730. Boxes
  1731. eoh
  1732.  
  1733. hs:3:1:Back Color
  1734. boh
  1735.   Selects the background color
  1736. for the Popup Boxes
  1737. eoh
  1738.  
  1739. hs:3:2:Text Color
  1740. boh
  1741.   Selects the color for text
  1742. for the Popup Boxes
  1743. eoh
  1744.  
  1745. hs:3:3:Frame Color
  1746. boh
  1747.   Selects the color for the frame
  1748. (border) of the Popup Boxes
  1749. eoh
  1750.  
  1751. hs:3:4:Okay
  1752. boh
  1753.   Exits this menu
  1754. eoh
  1755.  
  1756. hs:2:4:Data Window
  1757. boh
  1758.   Selects the colors for the data window
  1759. (the middle portion of the display)
  1760. eoh
  1761.  
  1762. hs:3:1:Back Color
  1763. boh
  1764.   Selects the background color for
  1765. the data window
  1766. eoh
  1767.  
  1768. hs:3:2:Frame Color
  1769. boh
  1770.   Selects the color for the frame
  1771. (border) of the Data window.  The
  1772. frame only appears if there are more
  1773. than one data window.
  1774. eoh
  1775.  
  1776. hs:3:3:Axis Color
  1777. boh
  1778.   Selects the color for the Grid
  1779. and Axes, if they are displayed,
  1780. in the Data Window
  1781. eoh
  1782.  
  1783. hs:3:4:A/D Data 0
  1784. hs:3:5:A/D Data 1
  1785. hs:3:6:A/D Data 2
  1786. hs:3:7:A/D Data 3
  1787. hs:3:8:A/D Data 4
  1788. hs:3:9:A/D Data 5
  1789. hs:3:10:A/D Data 6
  1790. hs:3:11:A/D Data 7
  1791. hs:3:12:A/D Data 8
  1792. hs:3:13:A/D Data 9
  1793. hs:3:14:A/D Data A
  1794. hs:3:15:A/D Data B
  1795. hs:3:16:A/D Data C
  1796. hs:3:17:A/D Data D
  1797. hs:3:18:A/D Data E
  1798. hs:3:19:A/D Data F
  1799. boh
  1800.   Selects the color for the data recorded
  1801. on one the indicated one of Patchit's
  1802. input channels.
  1803. eoh
  1804.  
  1805. hs:3:20:Okay
  1806. boh
  1807.   Exits this menu
  1808. eoh
  1809.  
  1810. hs:2:5:Use Defaults
  1811. boh
  1812.   Resets the colors for all
  1813. components of the Patchit display
  1814. to their default values.
  1815. eoh
  1816.  
  1817. hs:2:6:Okay
  1818. boh
  1819.   Keeps the color selections
  1820. that you have set here.
  1821. eoh
  1822.  
  1823. hs:2:7:Cancel
  1824. boh
  1825.   Cancels the color selections
  1826. that you have set here.
  1827. eoh
  1828.  
  1829. ------------------- Font ------------------
  1830. hs:1:4:Font
  1831. boh
  1832.   This allows the user to select the font
  1833. that is used by Patchit.  For all but the
  1834. default font, the requisite font file
  1835. (they have the extension ".chr") MUST be
  1836. present in the same directory as Patchit.
  1837. An example of some text written in the
  1838. selected font is displayed so that you
  1839. can see what it will look like.
  1840. eoh
  1841.  
  1842. hs:2:1:Font
  1843. boh
  1844.   This item allows the user to select the
  1845. font family that will be used by Patchit.
  1846. Eleven font families are available.  The
  1847. default font is a bit-mapped font (and
  1848. is drawn more quickly on the screen), the
  1849. others are stroked (outline) fonts (and
  1850. draw more slowly on the screen).
  1851.   For all but the default font, the
  1852. requisite font file (they have the
  1853. extension ".chr") MUST be present in the
  1854. same directory as Patchit.
  1855. eoh
  1856.  
  1857. hs:2:2:Height
  1858. boh
  1859.   Selecting this option allows the user
  1860. to set the height of the font that will
  1861. be used by Patchit.  If the selected
  1862. font family is the default, bit-mapped
  1863. font, the height and the width must be
  1864. the same (and Patchit will make that be)
  1865. eoh
  1866.  
  1867. hs:2:3:Width
  1868. boh
  1869.   Selecting this option allows the user
  1870. to set the width of the font that will
  1871. be used by Patchit.  If the selected
  1872. font family is the default, bit-mapped
  1873. font, the height and the width must be
  1874. the same (and Patchit will make that be)
  1875. eoh
  1876.  
  1877. hs:2:4:Okay
  1878. boh
  1879.   Selecting this causes any changes that
  1880. you have made to the font to go into effect.
  1881. eoh
  1882.  
  1883. hs:2:5:Cancel
  1884. boh
  1885.   Selecting this causes any changes that
  1886. you have made to the font to be discarded.
  1887. eoh
  1888.  
  1889. ------------------- Sounds ------------------
  1890. hs:1:5:Sounds
  1891. boh
  1892.   This allows the user to control aspects
  1893. of the sounds that Patchit generates
  1894. during its operation.
  1895. eoh
  1896.  
  1897. hs:2:1:Sounds
  1898. boh
  1899.   Selecting this toggles the state of
  1900. whether Patchit will generate sounds.
  1901. When disabled Patchit will make no
  1902. noise.
  1903. eoh
  1904.  
  1905. hs:2:2:Type
  1906. boh
  1907.   This allows the user to select the
  1908. type of sound generation Patchit will
  1909. use, these are:
  1910.   Single Tone:  Patchit will always
  1911. generate a tone of the specified
  1912. frequency and duration (see below) for
  1913. each data acquisition cycle.
  1914.   Rising Scale:  When the first record
  1915. is acquired, Patchit will generate a
  1916. tone of the specified frequency and
  1917. duration.  For the next and each
  1918. succeeding record, the tone generated
  1919. will be of a successively higher
  1920. frequency.
  1921.   From A/D:  Patchit will generate a
  1922. tone for each record based on the value
  1923. of a portion of the data.  When this is
  1924. selected the user is prompted for the
  1925. channel of data from which to record
  1926. the value and is then prompted for a
  1927. value from 0 to 1.  This value tells
  1928. Patchit from where in the record (0 is
  1929. beginning, 1 is end) to read the value
  1930. of the data on which to base the sound.
  1931. eoh
  1932.  
  1933. hs:2:3:Frequency
  1934. boh
  1935.   This allows the user to select the
  1936. frequency (in Hz.) of the sound.
  1937.   For "Single Tone" sound type, this is
  1938. the frequency of that tone.
  1939.   For "Rising Scale" sound type, this is
  1940. the frequency generated for the first
  1941. record.  For the next and each succeeding
  1942. record, the tone generated will be of a
  1943. successively higher frequency.
  1944.   For "From A/D" sound type, this is the
  1945. frequency of the lowest A/D value, If
  1946. this is the sound type, the user will
  1947. be prompted for a frequency corresponding
  1948. to the highest A/D value.
  1949. eoh
  1950.  
  1951. hs:2:4:Duration
  1952. boh
  1953.   This allows the user to set the
  1954. duration (in msec) of the sound.
  1955. eoh
  1956.  
  1957. hs:2:5:Test
  1958. boh
  1959.   When this is selected, Patchit
  1960. demonstrates the sounds that will
  1961. be generated during data acquisition
  1962. given the currently selected options.
  1963. If the tone type is "From A/D", the
  1964. demonstration plays the high and low
  1965. frequency values over and over.
  1966. eoh
  1967.  
  1968. hs:2:6:Okay
  1969. boh
  1970.   Selecting this, leaves the sounds menu.
  1971. eoh
  1972.  
  1973. ------------------- Display ------------------
  1974. hs:1:6:Display
  1975. boh
  1976.   This allows the user to control aspects
  1977. of how data is displayed on the screen.
  1978. eoh
  1979.  
  1980. hs:2:1:Show all pts in record
  1981. boh
  1982.   Selecting this toggles this option.
  1983.   If this is enabled then Patchit will
  1984. display all of the data points for a
  1985. given record on the screen.  That is,
  1986. if there are more data points in a
  1987. record than there are pixels on the
  1988. screen horizontally then Patchit will
  1989. show multiple Y points for each X point.
  1990.   If this is disabled then Patchit will
  1991. only display one Y point for each X
  1992. point.  Disabling this feature causes
  1993. the display to draw faster.
  1994. eoh
  1995.  
  1996. hs:2:2:Connect the points
  1997. boh
  1998.   Selecting this toggles this option.
  1999.   If this item is enabled then Patchit
  2000. will connect the data points on the
  2001. screen with lines.  This causes the
  2002. display of data to look nicer, but
  2003. significantly slows the display
  2004. of data.
  2005. eoh
  2006.  
  2007. hs:2:3:Auto-Erase (Storage)
  2008. boh
  2009.   Selecting this toggles this option.
  2010.   If this item is enabled then the
  2011. screen will automatically be cleared
  2012. whenever data is acquired or whenever
  2013. the pulse generator is activated.
  2014.   If this is disabled, then the screen
  2015. will not be cleared in either of these
  2016. cases.
  2017. eoh
  2018.  
  2019. hs:2:4:Grid and Axes
  2020. boh
  2021.   This option allows the user to configure
  2022. how the grid and axes in the data window(s)
  2023. are displayed.
  2024. eoh
  2025.  
  2026. hs:3:1:X Axis
  2027. boh
  2028.   This item allows the user to determine
  2029. where X axes are to be placed in the data
  2030. window(s).  The user can select a variety
  2031. of X axis configurations varying from no
  2032. X axis to three, appearing at the top,
  2033. middle and bottom of each window.
  2034. eoh
  2035.  
  2036. hs:3:2:Y Axis
  2037. boh
  2038.   This item allows the user to determine
  2039. where Y axes are to be placed in the data
  2040. window(s).  The user can select a variety
  2041. of Y axis configurations varying from no
  2042. Y axis to three, appearing at the left,
  2043. middle and right of each window.
  2044. eoh
  2045.  
  2046. hs:3:3:Grid
  2047. boh
  2048.   This item allows the user to determine
  2049. the display of the grid in the data
  2050. window(s).  The grid can be horizontal,
  2051. vertical, both horizontal & vertical or
  2052. neither.  The spacing of the grid is
  2053. determined by the number of divisions
  2054. (see next item).
  2055. eoh
  2056.  
  2057. hs:3:4:Divisions
  2058. boh
  2059.   This item allows the user to set the
  2060. number of divisions for both the X and
  2061. Y axes.  The number of divisions
  2062. determines where the ticks are placed
  2063. on the X and Y axes and the spacing of
  2064. the grid.
  2065. eoh
  2066.  
  2067. hs:3:5:Line Style
  2068. boh
  2069.   This item allows the user to set the
  2070. line style for the grid.  The line style
  2071. is specified by a hexadecimal number
  2072. (0 -> FFFF) which specifies how the line
  2073. is displayed.  FFFF corresponds to a
  2074. solid line, while 0 corresponds to no
  2075. line.  A value of  0F0F would make a
  2076. dashed line, while 1 would make a faintly
  2077. dotted line.  There are 65536 possible
  2078. configurations - why not try them all?
  2079. eoh
  2080.  
  2081. hs:3:6:Okay
  2082. boh
  2083.   Selecting this causes any changes that
  2084. you have made to the grid and axes to go
  2085. into effect.
  2086. eoh
  2087.  
  2088. hs:3:7:Cancel
  2089. boh
  2090.   Selecting this causes any changes that
  2091. you have made to the grid and axes to be
  2092. discarded.
  2093. eoh
  2094.  
  2095. ------------------- Other Options ------------------
  2096. hs:1:6:Other Options
  2097. boh
  2098.   This option allows the user to control
  2099. several very important aspects of Patchit's
  2100. operation.
  2101. eoh
  2102.  
  2103. hs:2:1:XMS Data Storage
  2104. boh
  2105.   Selecting this toggles this option.
  2106.   When this feature is enabled, Patchit will
  2107. use memory accessed via the XMS specification
  2108. in order to store data acquired before writing
  2109. it to disk.  XMS memory is memory above the
  2110. 1 MB boundary on PC-AT class computers (80286
  2111. and above class microprocessors).  This memory
  2112. can only be accessed if you have installed the
  2113. XMS driver HIMEM.SYS (supplied free of charge
  2114. by Microsoft), or a compatible XMS driver
  2115. (e.g. Desqview's QEMM memory manager) in your
  2116. config.sys file.
  2117.   The use of XMS allows Patchit to store data
  2118. above the conventional memory area, which allows
  2119. more room for Patchit to work.  This feature
  2120. need not be disabled unless you suspect a
  2121. problem or else have other needs.
  2122. eoh
  2123.  
  2124. hs:2:2:Startup Prm File
  2125. boh
  2126.   This allows the user to specify the name of
  2127. a parameter file that will be loaded whenever
  2128. Patchit is started.  This feature allows the
  2129. user to load a customized parameter set at
  2130. startup.  If this file is not found at startup,
  2131. Patchit will use a default set which may not be
  2132. correct for your experimental configuration!
  2133. (in particular the Output Scaling will almost
  2134. certainly be wrong).
  2135. eoh
  2136.  
  2137. hs:2:3:Okay
  2138. boh
  2139.   Selecting this causes any changes that you
  2140. have made to the items on this menu to be saved.
  2141. eoh
  2142.  
  2143. hs:2:4:Cancel
  2144. boh
  2145.   Selecting this causes any changes that you
  2146. have made to the items on this menu to be discarded.
  2147. eoh
  2148.  
  2149. ------------------- Write Config File ------------------
  2150. hs:1:7:Write Config File
  2151. boh
  2152.   When this option is selected the current
  2153. configuration data will be written to the
  2154. Patchit.cfg configuration file.  Only the
  2155. items that are on controlled by config menu
  2156. are stored in this file.  These are:
  2157. - Hardware Settings (type of board and
  2158.     hardware configuration)
  2159. - Graphics display adapter & resolution
  2160. - Colors
  2161. - Font
  2162. - Sounds
  2163. - Display Settings (Show All Pts, Connect
  2164.     the Pts, Auto-Erase,
  2165. Grid)
  2166. - XMS Usage
  2167. - Start Up Parameter File
  2168.  
  2169.   All other user-controllable parameters
  2170. are stored in the individual parameter (prm)
  2171. files.  These values will thus be set to
  2172. the value stored in the parameter file
  2173. whenever a new one is loaded.  Of these
  2174. parameters, one of the most critical (I
  2175. stress again) is the Output Scaling factor.
  2176. Please confirm that this value is set
  2177. properly in all of the parameter files which
  2178. you are using.  However, it may be that you
  2179. would desire different output scaling values
  2180. for different parameter files, so that is
  2181. why this value is stored in the parameter
  2182. file and not the configuration file.
  2183. eoh
  2184.